home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / 172anew.zip / QUES.DOC < prev    next >
Text File  |  1989-05-23  |  4KB  |  107 lines
  1. Documentation for Questionnaires
  2. RBBS 17.2A Version
  3. by Ken Goosens May 24, 1989
  4.  
  5. Warning:  config has a new option - the maximum number of work
  6. variables available.   This uses a previously unused parameter
  7. and therefore has a value of 0.   RBBS will increase this to 13.
  8. To reference more than 13 variables, you must set this parameter
  9. higher.
  10.  
  11. Questionnaires have been enhanced significantly in RBBS 17.2A.  Virtually
  12. all existing questionnaires will work the same with no modification.
  13. However, differences in operations are possible, including:
  14.  
  15. (1)  "[n]" in a label will be interpreted differently, where n is
  16.      an integer between 1 and 30.  Also, SmartText variables will
  17.      be interpreted as such, eg. ":-{FN" will substitute the
  18.      first name.
  19.  
  20. (2)  "*/FL" will no longer display the "/FL" because it is interpreted
  21.      as a command.
  22.  
  23. The major changes to questionnaires are:
  24.  
  25. o  there is an optional minimum security to run questionnaire.
  26.  
  27. Simply put the minimum security after the max security a questionnaire
  28. can raise security to, separating the two numbers by a space.  If
  29. there is no second number, anyone can use the questionnaire.  E.g.
  30. the first line
  31.  
  32.               "C:XXX.DAT",7 10
  33.  
  34. requires security 10 or more to run the questionnaire (and can raise
  35. security up to 7 and writes answers to file C:XXX.DAT).
  36.  
  37. o  graphics versions now supported.
  38.  
  39. Graphics versions use the standard convention of ending file prefix
  40. with "C" for color graphics and "G" for ansi graphics.  E.g.
  41. HLPRBBSC.DEF and HLPRBBSG.DEF are graphics versions of HLPRBBS.DEF.
  42.  
  43. o  SmartText and Work Variables are dynamically substituted into all
  44.    questionnaire lines.
  45.  
  46. For example, ">-.[8].-" will substitute the value of work variable 8
  47. for "[8]", so that if 8 has "edit" as its value, it will go to the 
  48. label "-.edit.-".
  49.  
  50. o  The prompt command accepts an option # to tell it what Work Variable
  51.    to store the answer in.
  52.  
  53. For example, "?8Enter Dept" will store the answer not only in the
  54. regular way for a questionnaire but also in work variable 8.
  55.  
  56. o  New commands to turn on turbo key (if user has it on), to assign
  57.    a value to a work variable, and to execute a macro.
  58.  
  59. "T" is the turbo command, "<2 RBBS" will assign "RBBS" as value to
  60. work varible 2, and "M VURBBS.MCR" will execute the macro called
  61. "VURBBS.MCR".
  62.  
  63. o  If you want to work variables to overlay a display template,
  64.    keeping it's length (e.g. for columnar display), put "/FL" after
  65.    the "*".  E.g. if variable 1 has value "12345" and 2 has "abcdef",
  66.    then
  67.  
  68.       */FL.[1]....[2]......
  69.  
  70.    will display ".12345..abcdef...", whereas
  71.  
  72.       *.[1]....[2]......
  73.  
  74.    will display ".12345....abcdef......".
  75.  
  76. One of the more useful macros is the ability to append data to any
  77. work file, where work variables are merged into a form.   This allows
  78. the questionnaire data to be saved in virtually any format desired.
  79.  
  80. Another extremely useful macro is the ability to retrieve data from
  81. a file into a form, in effect adding a data based file retieval
  82. capability.
  83.  
  84. The ability to get and substitute values, and to have graphics versions,
  85. means that questionnaires can support many of the features of full screen
  86. editing, including transmitting a template, then overlaying values into
  87. the template.
  88.  
  89. A good example of the new power of questionnaires is
  90.  
  91. ?29Change what field (1,2,...20)
  92. ?[29]Change field [29]. from [[29]] to
  93.  
  94. This asks which field to change and stores answer in work variable 29.
  95. E.g. value of work variable 29 is "7".   Second question then stores
  96. the answer in the value of work variable 29, displays the name of the
  97. work field being changed, then the old value of the work variable.
  98. Suppose that the value of work variable 7 is "Yes".   Then
  99. the series of substitutions RBBS makes into the second line before
  100. executing it are:
  101.  
  102. ?7Change field [29]. from [[29]] to
  103. ?7Change field 7. from [[29]] to
  104. ?7Change field 7. from [7] to
  105. ?7Change field 7. from Yes to
  106.  
  107.